Arrays

Arrays are one-based, random access collections of objects.  To create an array variable, declare:

var a := {}; // empty array
var b := { 5, 32, "hello", "world" }; // initialized array
var c := { {1,2}, {3,4,5} }; // array containing arrays

An array can be assigned to any other variable, even if that variable was not declared an array.  Therefore:

var a := { 2, 4, 6, 8 };
var b;
b := a;

is legal.

Similarly, if a function returns an array, no special declaration is needed:

var a;
a := function_that_returns_an_array();

Arrays grow automatically:

var a := {};
a[1] := 4;
a[4] := 7;

Arrays elements can be any type of object, including another array:

Local a := {};
Local b := {};
a[1] := 5;
b[1] := a;
b[2] := 6;

The following are equivalent methods of looping through an array.  The 'foreach' method is much more efficient, as well as being more convenient.

Local a := { 2,4,6,8 };

Local i;
for( i := 1; i <= len(a); i := i + 1 )
    print( a[i] );
endfor

foreach i in a
    print( i );
endforeach